home *** CD-ROM | disk | FTP | other *** search
/ Chip: Internet / Chip Internet.iso / viewer / vesaview / vesaview.doc < prev    next >
Text File  |  1993-09-10  |  71KB  |  1,382 lines
  1. VESAVIEW.EXE   v 5.0  
  2.  
  3.  
  4. TABLE of CONTENTS:
  5.      
  6.      Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  7.      
  8.      Brief Desc . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  9.      
  10.      LEGAL STUFF. . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  11.      
  12.      REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  13.      
  14.      DISCLAIMER . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  15.      
  16.      PROGRAM FILE LIST: . . . . . . . . . . . . . . . . . . . . . . .   4
  17.      
  18.      REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  19.      
  20.      FEATURES . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  21.      
  22.      INSTALLING PROGRAM:. . . . . . . . . . . . . . . . . . . . . . .   5
  23.      
  24.      RUNNING with COMMAND LINE QUALIFIERS . . . . . . . . . . . . . .   5
  25.      
  26.      SYSTEM DEFAULTS. . . . . . . . . . . . . . . . . . . . . . . . .   9
  27.      
  28.      CHANGING DIRECTORY . . . . . . . . . . . . . . . . . . . . . . .   9
  29.      
  30.      VIEW SINGLE IMAGE (from Text directory). . . . . . . . . . . . .   9
  31.      
  32.      VIEW MULTIPLE IMAGES (slide show) (from Text
  33.           directory) . . . . . . . . . . . . . . . . . . . . . .   9
  34.      
  35.      VIEW / CREATE AN ARRAY OF IMAGES (from Text
  36.           directory) . . . . . . . . . . . . . . . . . . . . . .   9
  37.      
  38.      AUTO ARRAY GENERATION/SAVING . . . . . . . . . . . . . . . . . .  10
  39.      
  40.      VIEWING FILES (from a previously created Array
  41.           image) . . . . . . . . . . . . . . . . . . . . . . . .  10
  42.      
  43.      VIEWING GIF89A FILES - Special Case. . . . . . . . . . . . . . .  11
  44.      
  45.      VIEWING HPG or PLT FILES . . . . . . . . . . . . . . . . . . . .  12
  46.      
  47.      VIEWING ASCII FILES: . . . . . . . . . . . . . . . . . . . . . .  12
  48.      
  49.      DELETING FILES . . . . . . . . . . . . . . . . . . . . . . . . .  12
  50.      
  51.      SEARCHING FILENAMES. . . . . . . . . . . . . . . . . . . . . . .  12
  52.      
  53.      SPECIAL KEYS WHILE VIEWING . . . . . . . . . . . . . . . . . . .  13
  54.      
  55.      SAVING SCREEN AS a  BMP, GIF or PCX FILE . . . . . . . . . . . .  14
  56.      
  57.      SAVING SCREEN AS a JPG FILE: . . . . . . . . . . . . . . . . . .  14
  58.      
  59.      CROPPING SCREEN & SAVING AS a  BMP, GIF, JPG or PCX
  60.           FILE . . . . . . . . . . . . . . . . . . . . . . . . .  14
  61.      
  62.      SCALING XMEM CONTENTS TO SCREEN & SAVING . . . . . . . . . . . .  14
  63.      
  64.      SAVING XMEM CONTENTS AS an IMG or PCX FILE . . . . . . . . . . .  14
  65.      
  66.      PRINTING IMAGES. . . . . . . . . . . . . . . . . . . . . . . . .  15
  67.      
  68.      MOUSE USE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  69.      
  70.      RUNNING Under WINDOWS 3.1: . . . . . . . . . . . . . . . . . . .  16
  71.      
  72.      CAUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  73.      
  74.      HINTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  75.      
  76.      CARDS TESTED . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  77.      
  78.      SUPPORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  79.      
  80.      REVISION HISTORY . . . . . . . . . . . . . . . . . . . . . . . .  18
  81.      
  82.  
  83. VESAVIEW.EXE   v 5.0
  84.  
  85.  
  86. Keywords: VESA BMP GIF IMG JPG PCX TGA TIF HPGL PRINT CATALOG VIEWER
  87.           DESKJET LASERJET PAINTJET
  88.  
  89. Brief Desc:    View and print BMP, GIF, IMG/GEM, JPG, PCX, TGA & TIF
  90.                images & HPGL plotter files.  Arrays of up to 144
  91.                images/screen can be generated and saved for easy
  92.                cataloging.  HPGL plot files can be saved as B&W
  93.                files.  Mouse support.  Requires a VESA driver for
  94.                your graphics card and enough extended memory to hold
  95.                entire image.   Supports VESA modes thru
  96.                1280x1024x256.  Quick panning of images larger than
  97.                your screen resolution. Color/brightness/contrast
  98.                adjustments, scaling & cropping of color images. Fade
  99.                control for slide shows. 24 bit color reduction for
  100.                BMP, JPG, TGA & PCX. Excellent Black & White printing
  101.                to HP DeskJet or LaserJet.  Superb Color printing to
  102.                HP PaintJet, PaintJet XL, PaintJet XL300 and DeskJet
  103.                500C/550C.  Images can be selected graphically from
  104.                previously created arrays.
  105.  
  106.  
  107.  
  108. LEGAL STUFF:   Copyright (c) William M. White 1992,1993.
  109.                Compuserve ID: 71170,2340
  110.  
  111. The VESAVIEW product is Shareware. If you find it useful, please
  112. register your copy and tell your friends about it.  This product may
  113. not be sold or packaged, either individually, or as part of any other
  114. product without the express written consent of the author. This
  115. product may not be changed or altered and then distributed without the
  116. express written consent of the author.  The VESAVIEW.DOC &
  117. VESAVIEW.LGO files must accompany VESAVIEW.EXE whenever the
  118. non-registered version is distributed.
  119.  
  120. The JPEG decoding and encoding portion of this program "is based in
  121. part on the work of the Independent JPEG Group".  "The Graphics
  122. Interchange Format (c) is the Copyright property of CompuServe
  123. Incorporated.  GIF (sm) is a Service Mark property of CompuServe
  124. Incorporated."
  125.  
  126. REGISTRATION:
  127.      Please send your $35.00 registration fee to:
  128.           William M. White
  129.           P. O. Box 2273
  130.           Glen Allen, VA. 23058-2273
  131.  
  132. By Registering your copy, you will receive an unhindered copy of the
  133. latest version of VESAVIEW and help support the continued development
  134. of the product.  You will also receive a personal User Access Code so
  135. that you can easily convert any new shareware versions from the
  136. following BBSs into your new registered copy, thus eliminating
  137. additional fees for update mailings.  Current shareware versions of
  138. the product will always be available on Compuserve in the GRAPHSUPPORT
  139. forum (GO PICS) and on the Blue Ridge Express Bulletin Board (804)-
  140. 790-1675.  Replacement or upgrade disks will be available for $10.00
  141. to cover handling.  NOTE:  Your registered copy of the program
  142. produces a file named VESAVIEW.REG which should never be distributed
  143. since it will be encoded with your name and access code..
  144.  
  145. DISCLAIMER:
  146.  
  147. VESAVIEW is offered to you on an as-is-basis without any guarantee as
  148. to the correct functioning or fitness for a specific purpose.  The
  149. author believes this program to work as described but you use the
  150. program entirely at your own risk.  The author will not be responsible
  151. for any hardware or software damage, loss of data, or incidental or
  152. consequential damage that may result from its use, whether or not such
  153. use is in accordance with the instructions.
  154.  
  155.  
  156. PROGRAM FILE LIST:
  157.  
  158. The following files make up the shareware version of VESAVIEW which
  159. may be distributed to other BBSs or friends:
  160.  
  161.      VESAVIEW.EXE   - Main program
  162.      VESAVIEW.LGO   - Logo Screen for SVGA
  163.      VESAVIEW.LGX   - Logo Screen for VGA
  164.      VESAVIEW.ICO   - Icon for use when running from Windows 3.1 
  165.      VESAVIEW.DOC   - ASCII version of document file
  166.      VESAVIEW.WP    - WordPerfect v 5.1/5.2 version of document file
  167.      FILE_ID.DIZ    - Brief program description used by some
  168.                       bulletin boards
  169.  
  170. NOTE:     After running VESAVIEW for the first time, a personal access
  171. file will be created named VESAVIEW.REG.  Please DO NOT distribute
  172. this file.
  173.  
  174. REQUIREMENTS:
  175.  
  176. o    IBM compatible 286 or better
  177. o    Extended memory (and driver such as HIMEM).  For 256 (& higher)
  178.      color files, you'll need 1 byte/pixel in your image.  For 2
  179.      color files, you'll need 1 byte per 8 pixels in your image. 
  180.      This program conforms to XMS 2.0 specification.  8MB of extended
  181.      memory is recommended expecially if you will be using graphic
  182.      array menus and working with JPEG files.
  183. o    Will use a math coprocessor if available
  184. o    A graphics card that supports the VESA BIOS EXTENSIONS for the
  185.      'Super VGA modes' either through hardware or a software driver. 
  186.      NOTE: If no VESA driver is found, you will be limited to
  187.      320x200x256 or 640x480x2 non-VESA modes which won't allow arrays
  188.      to be generated.
  189.  
  190. FEATURES:
  191.  
  192. o    Will read in any size up to 1280 x 1024:
  193.           BMP (Windows) -     16, 256 color & 24 bit (16 million
  194.                               colors)
  195.           GIF (Compuserve 87a/89a) -   16 & 256 color
  196.           IMG (GEM/Digital Research Inc) -   B & W
  197.           JPG (JPEG/JFIF) -   Grayscale & 24 bit (16 million colors)
  198.           PCX (Zsoft) -       2, 16, 256 color & 24 bit (16 million
  199.                               colors)
  200.           TGA (Targa) -       8,16, 24 & 32 bit (non-compressed RGB
  201.                               & Run length encoded RGB)
  202.           TIF -     B & W, 16c, 256c  & 24 bit (non-compressed & run
  203.                     length encoded)
  204.           HPG -     (Hewlett Packard) HPGL plot files (.HPG or .PLT)
  205.           TEXT -    ASCII files with up to 2000 lines with extensions
  206.                     of .1ST, .ANS, .ASC, .ASM, .BAT, .C, .DIZ, .DOC,
  207.                     .H, .LIS, .ME,  .TXT and .VNX.  
  208.  
  209. o    Files can be selected either from a text directory listing or
  210.      graphically from a previously created array of images (mouse
  211.      required for graphic selection).  Multiple selections are
  212.      displayed in the order selected.
  213.  
  214. o    If the file is larger than the screen mode you selected, you can
  215.      quickly pan around the image.  Size of image is limited only by
  216.      the amount of extended memory you have.  NOTE:  The entire image
  217.      is read into Extended memory to allow for quick panning of large
  218.      images.  Black & White images are stored in memory with 1 byte
  219.      per 8 pixels. 16 (4 bit) and 256 color (8 bit) images are stored
  220.      in memory with 1 byte per pixel.  24 & 32 bit images are stored
  221.      in memory as 256 color images so only 1 byte per pixel is
  222.      required.
  223.  
  224. o    Black & White printing (color images will be halftoned) and
  225.      Color printing are supported.  Prints can be sized, rotated and
  226.      positioned on paper.  Printers supported are HP LaserJet Series,
  227.      DeskJets, DeskJet 500/500C/550C, PaintJet, PaintJet XL, and
  228.      PaintJet XL300.
  229.  
  230. o    Red/Blue/Green/Contrast/Brightness values may be changed while
  231.      viewing a color image.  Image can be converted to GrayTone.
  232.  
  233. o    Color screen images can be saved as a 256 color BMP, GIF, JPG or
  234.      PCX file. These images may be cropped & scaled before saving.
  235.  
  236. o    Black & White images can be saved as an IMG or 2 color PCX file.
  237.      This is useful to save a HPGL file that is displayed on screen
  238.      out to a quicker retrieving raster file.  If these images are
  239.      displayed in a color VESA mode they can also be saved &/or
  240.      cropped as 256 color  BMP, GIF, JPG or PCX files.
  241.  
  242. o    Arrays of up to 144 images can be displayed on a single screen
  243.      at once.  This screen can then be saved as a single  BMP, GIF,
  244.      JPG or PCX file for cataloging or printing or use as a graphic
  245.      menu for VESAVIEW.
  246.  
  247. o    Supports VESA modes (assuming your graphics card can handle):
  248.           100 -  640 x  400 x 256
  249.           101 -  640 x  480 x 256
  250.           103 -  800 x  600 x 256
  251.           105 - 1024 x  768 x 256
  252.           107 - 1280 x 1024 x 256
  253.  
  254. o    Will support a 800 x 600 x 2 color B&W mode if your card has
  255.      one.  (See /SVn option below)
  256.  
  257. o    Supports the use of a MicroSoft compatible 2-button mouse.
  258.  
  259. NOTE:     The annoying beeps and NON-Registered notices will be
  260.           removed from registered copies.  Also, the NON-Registered
  261.           version does not support the new printing options (sizing,
  262.           rotating and positioning), nor the Compressing of printer
  263.           data.
  264.  
  265. INSTALLING PROGRAM:
  266.  
  267. Create a directory on your HardDrive to hold the VESAVIEW program
  268. files.  Copy the zipped file you downloaded from a BBS or received on
  269. diskette into this directory.  The ZIP file is usually named
  270. VESAVWnn.ZIP where nn represents the version number.  Unzip it using
  271. PKUNZIP version 2.04g or higher (earlier versions will not work).  Set
  272. your default directory to the VESAVIEW directory you've created and
  273. type in VESAVIEW to run the program.  The first time you run it,
  274. you'll be asked to enter your registration information including User
  275. Name and Access Code.  This personal access information will be stored
  276. in a new file named VESAVIEW.REG in your VESAVIEW directory.  Please
  277. DO NOT distribute this file.  All files in the original zipped file
  278. may be distributed to your friends or other BBS as the Shareware
  279. version.
  280.  
  281. RUNNING with COMMAND LINE QUALIFIERS:
  282.  
  283. Make sure you have enough extended memory available and that a driver
  284. (such as HIMEM) is loaded.  Make sure your graphics card has VESA BIOS
  285. EXTENSIONS (VBE) either built-in or that you have installed a VESA
  286. software driver.  Keyin:
  287.  
  288.      VESAVIEW [/AB or /AW] [/AMmode] [/AS] [/CS, /CO or /COD] [/Dn]
  289.      [/Fn] [/FN, /FB or /BW] [/FTMn] [/LOmode] [Mx] [/NB] [/NLAM]
  290.      [/P1, /P2 or /PF] [/PAn] [/PC] [/PGn] [/PLMn] [/PRn] [/PTMn]
  291.      [/PSBH, /PSBS, /PSCH or /PSCS] [/PTDJ, /PTLJ, /PTPJ, /PTPJXL,
  292.      /PTPJXL3, /PTDJC or /PTDJ5C] [/PWn]  [/SVn] [/UPSA, /UPSB or
  293.      /UPSC] [/WN, /WH or /WF] where items in brackets are optional.
  294.  
  295. CAUTION:  DOS has a limitation of 127 characters on the command line. 
  296. If you exceed this when adding qualifiers, some may be truncated.
  297. NOTE: Underlined (or *) qualifiers are only available in the
  298. REGISTERED VERSION.  The optional qualifiers can also be changed while
  299. in the program by pressing <O> (or pointing to OPTS with the mouse). 
  300. These changes are only for the current session and will not be saved. 
  301. A 'space' is needed between each qualifier on the command line.  If
  302. you wish to use the same qualifiers each time you evoke the program,
  303. write a BAT file like:
  304.  
  305.      CD \GIF             rem Assumes your graphics files are here
  306.      \VV\VESAVIEW /P1 /NW /CO rem Assumes program in VV dir
  307.  
  308. The /AB forces the array mode to use a black background and white text
  309. for the filenames.  
  310. The /AW forces the array mode to use a white background and black text
  311. (saves black ink when printing).
  312.  
  313. The /AMmode (where mode is 100, 101, 103, 105 or 107) will let you
  314. default to a specific mode when displaying arrays.  The program will
  315. default to mode 101 if this switch is not used.  Only use a mode
  316. number that your card can support!
  317.  
  318. The /AS (array sizes) enables the display of image sizes above each
  319. image of an array.  The size will be displayed after the filename of
  320. each image only if it will fit.  Typically at a resolution of
  321. 1024x768, the sizes will fit on 6x6 arrays and below.  At 800x600, the
  322. sizes will fit on 5x5 arrays and below.  At 640x480, the sizes will
  323. fit on 4x4 arrays.  Each image is tested individually, so on a given
  324. array screen, some sizes may appear and some may not.  You will see
  325. the sizes displayed after all images on a page have been processed.
  326.  
  327. The /CO (color-optimized) will force 16, 24 & 32 bit images to be
  328. processed using an optimized 256 color palette.  The process reads in
  329. all the colors in your image, creates a histogram of the most used
  330. colors, and then creates an optimized palette of the results. The
  331. processing time is greater than if the /CS option is used, but the
  332. results are spectacular.  The color reduction method used is much
  333. faster than that of other program that  I have tested.  After the
  334. image has been displayed on the screen, you might want to save it as
  335. a 256 BMP, GIF, JPG or PCX file, so that the next time you want to
  336. display it, you can use the quicker 256 color version.
  337.  
  338. The /COD qualifier is similar to /CO above, expect that besides using
  339. an optimized palette, the image will also be dithered to smooth out
  340. the transition between colors.
  341.  
  342. The /CS (color-standard) will force 16, 24 & 32 bit images to be
  343. displayed using a standard palette.  The colors will be adequate for
  344. previewing, but for more exact colors, use the /CO.
  345.  
  346. The /Dn (delay) is for setting the delay in seconds to use between
  347. slides.  The n is an integer number from 1 to 999 and defaults to 5
  348. seconds.  This time is approximate and will vary depending  on the
  349. size of the image being read in.
  350.  
  351.  
  352. The /Fn (fade) option will fade in and out your images on screen when
  353. displaying them as a slide show.  The n can range from 0 to 10.  0 is
  354. no fade, 1 is the fastest fade and 10 is the slowest fade.
  355.  
  356. The /FN, /FB or /FW specify the foreground color (N=none, B=Black and
  357. W=White) of your Black & White images.  By specified foreground color,
  358. the program will be able to save more of your image's original context
  359. when scaling down.  This qualifier works best if your images are line
  360. drawings and not pictures.  For example, if your image appears on the
  361. screen as black lines on a white background, use the /FB qualifier. 
  362. If your images don't have a main foreground color such as the case
  363. with pictures, use /FN. Note that using either the /FB or /FW
  364. qualifiers will increase the processing time for B&W scaling.  If you
  365. don't need the increased quality, use /FN.
  366.  
  367. The /FTMn (fixed top margin) option will allow you to override the
  368. program's default values for that part on the top of a page that your
  369. printer can't print on.  The defaults are:
  370.      0.1" -    DeskJet, DeskJet 500, DeskJet 500C
  371.      0.05"-    DeskJet 550C
  372.      0.0" -    LaserJet Series, PaintJet XL, PaintJet XL300
  373.      0.0" -    PaintJet (tractor feed)
  374.  
  375. If your printed margins don't match what you set in the Printer Setup
  376. Menu, then use this qualifier to adjust them.
  377.  
  378. The /IDx (index drive override) option will allow you to override the
  379. drive that is embedded in the graphic menu index files (.VNX).  This
  380. is useful if you create graphic menus and their indexes on one drive
  381. and later move them to another drive.  x is the drive letter (A-Z) you
  382. want to use instead of the one in the index file, or make x = 0 to use
  383. the current drive you're on.  The other alternative to this qualifier
  384. is to actually edit the first line in the index file (.VNX) to reflect
  385. the new drive letter.
  386.  
  387. The /LOmode (lockout mode) (where mode is 100, 101, 103, 105 or 107)
  388. will lock out a mode.  This is useful if your VESA driver is designed
  389. for a graphics card which has been fully populated with memory chips
  390. but your card doesn't have all of this memory installed.  You may use
  391. more than one of these switches on your command line.
  392.         
  393. The /Mx (mask for filenames) will allow you to include only certain
  394. file types in your directory listing.  It can be one of the following: 
  395.  /MALL (all filenames), /MDIS (all displayable graphics files), /MBMP
  396. (only *.BMPs), /MGIF (only *.GIFs),  /MIMG (only *.IMGs), /MJPG (only
  397. *.JPGs), /MPCX (only *.PCXs), /MTGA (only *.TGAs) /MTIF (only *.TIFs). 
  398. Note:  Array index files (.VNX) are always accessible by the program,
  399. even if they are not being displayed in your directory listing. 
  400. Caution:  When you use this qualifier to eliminate the display of
  401. certain file types from your screen, and you display a previously
  402. created array image that includes file types that are not currently
  403. displaying, those files will not be found even though they are
  404. actually in the directory. (they will be flaged on screen with a red
  405. crosshatch)
  406.  
  407. The /NB (no beep) option will disable the beeps after images are
  408. displayed on screen.  The default is to beep.
  409.  
  410. The /NLAM (no load array into memory) will disable the automatic
  411. loading of the first graphic array menu into XMEM even if there is
  412. enough memory to do so.  The program by default will load the first
  413. array image that will be used as a graphic menu into XMEM, if there
  414. is enough memory to hold this array and one more image (both are
  415. assummed to be the maximum size of 1280x1024x256).  If you are low on
  416. XMEM and you wish to be able to pull up larger files (B&W for example)
  417. from the array menu, you will probably need to use this qualifier.
  418.  
  419. The /P1 or /P2 (port) designates which printer port to use for
  420. printing (LPT1 or LPT2).
  421. The /PF option forces printer output to a file instead of a port.  The
  422. file will be created in your current directory with the same filename
  423. as your image file but with an extension of  .VVP .  This option works
  424. with multiple plots as well.  No checking for duplicate filenames is
  425. done.  To plot the file(s), from DOS keyin:
  426.      COPY/B  filename.VVP  LPT1:  
  427. where filename could be a wildcard and LPT1: could be LPT2:.  The /B
  428. instructs DOS to use a binary copy mode.
  429.  
  430. The /PAn (print angle) is used to rotate your print on the printed
  431. page.  Values for n can be 0, 90, 180 or 270.
  432.  
  433. *    The /PC (print compress) option will force the transfer of data from
  434. your computer to the printer to be in a compressed (encoded) format. 
  435. This will speed up the transfer of data (especially for serial or
  436. networked printers).  Time savings will vary depending on the type and
  437. size of plot.  In some cases, you may find no time savings overall
  438. since the printer has to decompress the data, but your CPU should be
  439. freed up from processing sooner.  (default is no compress).  The
  440. PaintJet and LaserJet II don't support this type of data compression. 
  441. If your printouts look garbled, don't use this qualifier.
  442.  
  443. The /PGn (print gamma correction) option will allow you to adjust the
  444. gamma of your Black & White or Color print.  Simply put, gamma
  445. correction will adjust the intensities of red, green & blue values
  446. logarithmically since the human eye's perception of color intensity
  447. is non-linear.  The gamma value is a decimal value between 0.5 and
  448. 2.0.  If set to 0, no gamma correction will be performed.  If this
  449. qualifier is not used, gamma defaults to a value best suited for the
  450. printer type selected.  Using higher values will result in the darker
  451. colors in your image being printed lighter and the lighter ones
  452. remaining the same.  This gives a much more natural looking printout.
  453.  
  454. *    The /PRn (printer resolution) is used to specify the resolution in
  455. dots per inch (dpi) of your active printer.  For the DeskJet series,
  456. it can be 75, 150 or 300.  For the PaintJet series (except XL300), it
  457. can be 90 or 180.  Defaults to highest resolution for selected
  458. printer.
  459.  
  460. The /PSx (print style) option allows you to select the style of
  461. printing for Black & White or Color prints.  It can be one of the
  462. following:  /PSBH (B&W Halftone), /PSBS (B&W Scatter), /PSCH (Color
  463. Halftone) or /PSCS (Color Scatter).  The Halftone styles will process
  464. much faster than the Scatter dithering types which use an error
  465. difusing algorithm, however, the Scatter styles will in most cases
  466. have much better detailing and quality.  Halftoning is the default.
  467.  
  468. The /PTx (printer type) is used to select your printer.  It can be one
  469. of the following:  /PTDJ (HP DeskJet), /PTLJ (HP LaserJet), /PTPJ (HP
  470. PaintJet), /PTPJXL (HP PaintJet XL), /PTPJXL3 (HP PaintJet XL300),
  471. /PTDJC (HP DeskJet 500C) or /PTDJ5C (HP DeskJet 550C).
  472.  
  473. *    The /PWn (print width) is used to specify a print width.  It is a
  474. decimal value from 0.0 to 10.5.  If you enter a number greater than
  475. 8.0, the print will automatically be rotated 90 degrees.  The print
  476. width represents the width that you want the horizontal image
  477. dimension as seen on your screen to be printed, no matter what
  478. rotation angle you use.
  479.  
  480. *    The /PTMn (printer top margin) sets the number of inches from the
  481. current position of printhead that the image will start printing.  It
  482. is a decimal value ranging from the minimum value of your printer (see
  483. /FTMn above) to 10.0.  If set to 99, your image will be centered from
  484. top to bottom.
  485.  
  486. *    The /PLMn (printer left margin) sets the number of inches from the
  487. left side of page that the image will start printing.  It is a decimal
  488. value from 0.25 to 7.5.  If set to 99, your image will be centered
  489. from left to right.  The maximum printable width on all printers is
  490. 8.0" (1/4" left & right margins).
  491.  
  492. The /SVn (SVGA) will allow you to use a 800 x 600 x 2 color mode to
  493. display IMG or HPGL files in a high resolution mode if your graphics
  494. card supports it.  The n is the decimal mode number that your card
  495. uses for this mode.  Most Paradise cards use 41 decimal for this mode,
  496. and the Tseng cards (including Orchid) use 89 decimal.  This special
  497. mode and the standard 640 x 480 x 2 mode will allow faster panning on
  498. screen than the same resolutions in VESA modes will for large B & W
  499. images.  NOTE: The panning icon which is available in VESA modes is
  500. not available for B & W modes.
  501.  
  502. The /UPSA, /UPSB & /UPSC (unknown plot size) qualifiers will allow the
  503. user to specify a default plot size (A, B. or C) if the program that
  504. created the .PLT file did not include the HPGL cmd PS to signify what
  505. the Plot Size was.  If one of these qualifiers is not used, and the
  506. .PLT file doesn't have a PS cmd, VESAVIEW will default to a 'C' size
  507. plot.
  508.  
  509. The /WF (full weights) will display the weights as originally drawn.
  510. The /WH (weight half) is similar to /WN except that the weights of
  511. lines will be halved (divided by 2).
  512. The /WN (weight none) will not display weights of lines in an HPGL
  513. plot file if the SP (select pen) keyword was used when creating the
  514. plots.  This will greatly speed up the screen drawing if you don't
  515. need to look at or print the weights.  Some CAD programs which
  516. generate the plot files create weighted lines by simply drawing the
  517. lines multiple times in the plot file (each slightly offset) and not
  518. by using the SP (set pen) command.  The /WN & /WH switches will have
  519. no effect on this type of plot files.
  520.  
  521.  
  522. SYSTEM DEFAULTS:    /AB /AM101 /COD /D5 /F0 /FB /MALL /P1 /PTDJ
  523.                     /PW8.0 /PA0 /PTM0.25 /PLM0.25 /PXS1.0 /PYS1.0
  524.                     /UPSC  /WF
  525.  
  526.      Ex:  VESAVIEW /P2 /AW /D10  - Will use printer port LPT2:,
  527.      display arrays with a white background, and delay 10 seconds
  528.      between slides.
  529.  
  530.      Ex:  VESAVIEW /LO105 /LO107 /AM103 - Will lockout modes 105 and
  531.      107 from being valid VESA modes and will use mode 103 when
  532.      displaying arrays.
  533.  
  534. The program will test to see if your graphics card supports the VESA
  535. Bios Extensions by either hardware or software driver, whether you
  536. have a HIMEM driver loaded and how much extended memory you have
  537. available.
  538.  
  539. Use the <ESC> key to exit program.  A mouse button can not be used to
  540. exit the program.
  541.  
  542. CHANGING DIRECTORY:
  543.  
  544. While the list of files is on your screen, you can change your current
  545. directory by placing the cursor on the lite blue entries (which are
  546. directory names) and pressing <ENTER>.  The . (single dot) will take
  547. you back to the root directory, and the .. (double dots) will take you
  548. back one directory level.  Selecting a yellow Disk Drive entry will
  549. change your disk drive.
  550.  
  551. You can also press the <C> key (or point to CDIR with mouse) to keyin
  552. a new path that can include a new disk drive. (Ex: B: or B:\ or C:\GIF
  553. or C:\IMAGES\GIF or \GIF or \GIF\).  NOTE that the program tolerates
  554. trailing backslashes.
  555.  
  556. VIEW SINGLE IMAGE (from Text directory):
  557.  
  558. To view a single image move the cursor (with arrows, pageup, pagedown,
  559. home or end keys) to the desired image file and press <ENTER>.  Then
  560. select a Vesa Mode from the Mode Menu. An asterisk denotes the Best
  561. Mode (calculated by the program) which will display the most of your
  562. entire image on a single screen in the best resolution.  After your
  563. image is displayed, press <ESC> (or right mouse button) to return to
  564. main menu.  Note that when viewing IMG files or HPGL files, you can
  565. use a VESA mode (only B&W colors used), use the standard 640 x 480 x
  566. 2 mode or use the Super VGA mode that you optionally entered on the
  567. command line.  Entries in gray on the Mode Menu are not available for
  568. your graphics card.
  569.  
  570. VIEW MULTIPLE IMAGES (slide show) (from Text directory):
  571.  
  572. To view multiple images as a 'slide show', use the <Space Bar> (or
  573. right mouse button) to select the images you wish to view.  You can
  574. mark all images in the current directory with the <M> key (or point
  575. to MARK with mouse) or unmark them with the <U> key (or UNMARK with
  576. mouse).  These can include BMP, GIF, IMG, JPG, PCX, TGA, TIF, PLT and
  577. HPG files.  By pressing the <C> key, you can change your current Disk
  578. &/or Directory.  Press <ENTER> (or left mouse button) to start the
  579. slide show.  The files will be displayed one by one in the best VESA
  580. mode as determined by the program (640x480x2 mode is used for PLT &
  581. HPG files).  The delay between slides will vary depending on the time
  582. it takes to read in the next file while one is on your screen and the
  583. value used in the  /Dn switch.  Fading in and out between multiple
  584. images can be done by using the /Fn switch.  After the last file is
  585. displayed, the program will loop back to first slide.  Pressing <ESC>
  586. (or right mouse button) during the display will stop the slide show.
  587. (this may take several seconds).  Note:  Files will be displayed  in
  588. the order in which they were selected.  You can pause the slide show
  589. by pressing the <Pause> key on keyboard.  Any other key will continue
  590. the show.
  591.  
  592. VIEW / CREATE AN ARRAY OF IMAGES (from Text directory):
  593.  
  594. To view multiple images on a single screen at once, use the <Space
  595. Bar> (or right mouse button) to select the images you wish to view. 
  596. These can include BMP, GIF, IMG, JPG, PCX, TGA and TIF files but not
  597. PLT or HPG files.  Press <A> (or point to ARRAY with mouse) to select
  598. array display.  Select the VESA mode from Mode Menu and then select
  599. the number of images to display per screen page. Then sit back and
  600. watch your images appear.  Pressing <ESC> (or right mouse button) will 
  601. abort the display after the current image is displayed.  After each
  602. page is displayed, you could press <B> to save the currently displayed
  603. page as a Windows BMP file, <G> for GIF file, <J> for JPG or <Z> for
  604. ZSoft PCX file or <PAGE DN> will continue to display the next page.
  605.  
  606. If you used the /AS qualifier or selected 'Show Array Sizes' from the
  607. Options Menu, the image sizes will be displayed alongside the
  608. filenames.
  609.  
  610. Since each image uses it own unique 256 colors, a special optimized
  611. color table and color dithering is used to display arrays.  Note that
  612. when displaying a 2-color file in an array, the scaling down of the
  613. original image (especially a line type drawing) will cause much of the
  614. info to be lost on the screen unless the /FB or /FW command qualifier
  615. is used.
  616.  
  617. Creating arrays of your images is a good method of saving a sequence
  618. of images for a slide show.  They are saved in the array in the order
  619. you selected them.  To play them back, just pull up that array image,
  620. press 'M' to mark all images, and press left mouse button to display
  621. them.
  622.  
  623. WARNING:  Files with more than 81 (9 x 9) images per page should not
  624. be viewed with versions of VESAVIEW prior to version 5.0 since a
  625. system hangup could occur because of internal array variable overflow!
  626.  
  627. NOTE:  Arrays are only available in VESA modes.  Files will be
  628. arranged in the array in the order in which they were selected.
  629.  
  630. AUTO ARRAY GENERATION/SAVING:
  631.  
  632. If you are going to have many pages (screens) of array images and you
  633. will be saving them all out as single files, you can do this
  634. automatically by the <G> (or point to AUTO/GEN with mouse) to activate
  635. the generate option.  This will automatically display the arrays on
  636. the screen and then save them out without any user intervention until
  637. the last one is processed.  You begin just as you would for the
  638. standard array option by selecting the files to display, the VESA
  639. mode, and then the number of images/page. You are first prompted for
  640. the file type to use when saving.  Then you are prompted for the first
  641. 1-6 characters of the filename that the program will use for the files
  642. it generates.  You may precede the filename with a Disk & Directory
  643. if you don't want to use the current Disk/Dir.    The system will
  644. append a 2 digit page number and appropriate extension to your input.
  645.  
  646. EX:  You are going to have 3 pages of array images and you select
  647. <G>IF as the filetype and  enter TEST as the filename.  The System
  648. will generate 3 files named TEST01.GIF, TEST02.GIF & TEST03.GIF.
  649.  
  650. VIEWING FILES (from a previously created Array image):
  651.  
  652. If you have previously created and saved an array of images, you can
  653. use it to graphically select the images you want to display either
  654. singularly or as a slide show or for plotting.  NOTE: A mouse is
  655. required for this mode.  Just select the array image from the Text
  656. directory listing.  After it is displayed, use the box shaped cursor
  657. to select the files.  The left mouse button will select one file and
  658. display it immediately.  The right mouse button is used to Mark/Unmark
  659. files for a slide show or multiple plotting. Files are outlined with
  660. a red box when they are marked.  If a file on your array menu does not
  661. exist in your current any more, the file will be cross-hatched with
  662. red lines.   After all files you desire are marked, press the left
  663. mouse button to start the display.  The /Dn and /Fn (delay and fade)
  664. work with multiple selections from arrays.  Files will be displayed
  665. in the order that they were selected on the screen.  If you want to
  666. display all of the files in the same order they were created, just
  667. press 'M' to mark them all, and press the left mouse button to start
  668. the show.  NOTE: Normally a right mouse button is used to Quit the
  669. current image, but since that button is used to Mark/Unmark files in
  670. the array menu, you must simultaneously press both the left and right
  671. button to Quit.  You can still use the <ESC> key to quit.
  672.  
  673. Array images created before VESAVIEW version 4.0 will not allow
  674. graphic file selection.  Version 4.0 and above creates an additional
  675. index file for each array image you create.  This file will have the
  676. same filename as your array image but with an extension of  .VNX . 
  677. If this files does not exist in the same directory as your array image
  678. file, you will not be able to use the array image as a graphic menu,
  679. but you can still view it as a normal image.  The index file is very
  680. small, and unlike other graphic packages which allow graphical
  681. selection of images from the screen, VESAVIEW does not require
  682. separate THUMBNAIL files for each image which saves considerable time
  683. and disk space.  As of version 4.3, the array image together with its
  684. index file may be stored (or saved) on a Disk/Directory that is
  685. different from the location of the images in the array.  This will
  686. allow users to catalog images from CDROMs (which can't be written to)
  687. etc.  VESAVIEW assumes that if your array images have nested arrays,
  688. all of these arrays are located in the same directory, but each of the
  689. array's images can be located on different Disk/Directories if needed. 
  690. The index file stores the Disk & Directory of the images in the array. 
  691. NOTE:  If you ever move your images from where the array was initially
  692. created, you will either need to re-catalog them or use a text editor
  693. to change the path (first entry) in the .VNX file.  To make the index
  694. file downward compatable with versions prior to 4.3, the program will
  695. accept index files that didn't store the images path in them as the
  696. first entry.
  697.  
  698. Up to six levels of array menus can be used (nested).  For example,
  699. you could have one array image that had other array images in it.  One
  700. idea would be to have individual array images for BMPs, GIFs, JPGs,
  701. PCXs and TGAs.  Then have a master array image which would include the
  702. BMP, GIF, JPG, PCX  and TGA arrays.  While an array image is
  703. displayed, selecting another array image from it will pull up that new
  704. array menu and so on.  If you have displayed an image out of a sub-
  705. level array menu, the <ESC> or right mouse button will return you to
  706. the previously displayed array menu. (remember that if you are
  707. displaying an array file, you must use both the left and right mouse
  708. button together to return to previous image).
  709.  
  710. If you need to add or delete an image from the array image, you will
  711. need to re-create it.  New array images can only be created from the
  712. Text directory listing.
  713.  
  714. Additional Keys available while displaying an array image:  
  715.  
  716.      M1 (left mouse button)   Used to start displaying a single or
  717.                               marked multiple images
  718.      M2 (right mouse button)  Used to Mark or Unmark files
  719.      M1 & M2 (together)       Used to Quit from an array image
  720.  
  721. (See 'SPECIAL KEYS WHILE VIEWING'  later for standard keys available)
  722.      
  723. Warning: You cannot have different array files with the same filename
  724. and different extensions in the same directory since each file will
  725. use the extension .VNX for its index file.   Ex:  You cannot have
  726. DIR01.GIF and DIR01.BMP array files in the same directory since the
  727. program would not know which one the index file DIR01.VNX should be
  728. associated with.
  729.  
  730.  
  731. VIEWING GIF89A FILES - Special Case:
  732.  
  733. If you are viewing a single GIF89A file, most of the 89A extensions
  734. will be processed including multiple images, plain text and control
  735. blocks.  Comments will not be displayed.  Because of the way VESAVIEW
  736. reads images into Extended memory before displaying them, the plain
  737. text will only be displayed on the screen (not XMEM).  This will
  738. prevent the printing of the text since printing is done from what is
  739. in Extended memory.  One way around this, if your screen has enough
  740. resolution to display the entire file, is to save your screen out to
  741. another file with <G> and then pull up that file and print it.  NOTE,
  742. that the save commands will only save out what is on the screen after
  743. all of the 89A extensions are processed.  If the extensions include
  744. delays between images, or require the user to <press> a key, the
  745. program will continue after 15 seconds maximum so that slide shows
  746. will not be put in a wait state looking for user input.  
  747.  
  748. If you are viewing arrays which include GIF89A files, the extensions
  749. will be processed entirely in XMEM before displaying them in the
  750. array.  No text extensions will be displayed (they would probably be
  751. too small to read anyway).  Delays between GIF89A extensions are not
  752. processed when displaying array images for increased speed.
  753.  
  754. VIEWING HPG or PLT FILES:
  755.  
  756. To view a plot file created in a HPGL format, move the cursor to the
  757. filename and press <ENTER>.  Then choose the Display Mode and Plot
  758. Mode you wish to use.  The program will try and determine the size of
  759. plot from the plot file header, but some CADD packages don't supply
  760. this info in which case the program will assume a "C size".  The HPGL
  761. codes for Plot Sizes are:
  762.  
  763.      PS4 = 'A' size
  764.      PS0 = 'B' size
  765.      PS1 = 'C' size
  766.  
  767. Choosing a display mode of FIT, 2X or 4X will speed up the drawing
  768. process but the resolution of the image will be diminished. As the
  769. image is decoded, you will see it being drawn in a preview mode at
  770. screen size.  After the image is complete, pressing any key will swap
  771. you to the actual image as stored in Extended memory for panning
  772. around in.  Pressing <ESC> (or right mouse button) as the image is
  773. being decoded will abort it.
  774.  
  775. Currently supported HPGL commands are:  PU,PD,PA,PR,PS,IP,SC,SP, CI
  776. and AA
  777.  
  778. Even though the LB,SI,SR,DF,DI & DR commands are parsed and used to
  779. display the image on the initial preview screen, they are not
  780. supported as the drawing is being created in Extended memory. This
  781. won't usually pose a problem since this program was designed to view
  782. HPGL files created by CADD programs and most of those programs
  783. represent Text etc. as vector elements.
  784.  
  785. WARNING:  Only plot files which were created as C size or smaller
  786. should be viewed, since the program does no checking for elements
  787. which could be drawn 'off' the page if too big.  This check was
  788. omitted to speed up the drawing.
  789.  
  790. VIEWING ASCII FILES:
  791.  
  792. To view a single ASCII file on your screen, just select it as with any
  793. other filetype.  The file will be displayed in a text window.  The
  794. following file extensions are recognized as ASCII files -  .1ST, .ANS,
  795. .ASC, .ASM, .BAT, .C, .DIZ, .DOC, .H, .LIS, .ME,  .TXT and .VNX.  You
  796. may use the following keys while viewing an ASCII file:
  797.      Pan Up a Line       - UP ARROW or RIGHT MOUSE BUTTON
  798.      Pan Down a Line     - DOWN ARROW or LEFT MOUSE BUTTON
  799.      Pan Up a Page       - PAGE UP
  800.      Pan Down a Page     - PAGE DN
  801.      Abort               - ESC or Both LEFT & RIGHT MOUSE BUTTONS
  802.                            simultaneously
  803.  
  804. NOTE:  ASCII files cannot be viewed from a graphics menu or in a slide
  805. show.  Only the first 2000 lines of a file will be displayable.  The
  806. entire file is not stored in memory but accessed from the disk drive
  807. as needed.
  808.  
  809. DELETING FILES:
  810.  
  811. While the file list is displayed on your screen, you may delete a file
  812. by moving the cursor to it and pressing <DEL> on the keyboard.  To
  813. delete multiple files, mark them with the <spacebar> (or right mouse
  814. button) and then press <DEL>.  You will be asked to confirm each
  815. deletion.
  816.  
  817. SEARCHING FILENAMES:
  818.  
  819. While the file list is displayed on your screen, you may select files
  820. by searching their filenames for a specific string.  Press <S> (or
  821. point to SEARCH with mouse) and keyin the search string.  The file
  822. will be selected if it contains the exact string anywhere in its
  823. filename.  Don't use the wildcard characters * or ? since they will
  824. be search for literally.
  825.  
  826. SPECIAL KEYS WHILE VIEWING:
  827.  
  828. While viewing images in a VESA mode (other than arrays):
  829.  
  830.      F1/F2     Increase/Decrease RED
  831.      F3/F4     Increase/Decrease GREEN
  832.      F5/F6     Increase/Decrease BLUE
  833.      F7/F8     Increase/Decrease RED
  834.      F9/F10    Increase/Decrease RED
  835.      ALT F9    Change to Gray tones
  836.      ALT F10   Restore original palette
  837.      B         Create a BMP file (256 c) of screen contents
  838.      C         Crop an image and save as  BMP, GIF, JPG or PCX file
  839.      G         Create a GIF file (256 c) of screen contents
  840.      H or ?    Graphics Help
  841.      J         Create a JPG file (24 bit) of screen contents
  842.      P         Send XMEM contents to printer as B&W or Color image
  843.      S         Scale XMEM contents to screen and save as BMP, GIF,
  844.                JPG or PCX file
  845.      V         Display the current VGA palette
  846.      Z         Create a PCX file (256 c) of screen contents
  847.      +         Zoom in (change VESA resolution to next lower mode)
  848.      -         Zoom out (change VESA resolution to next higher mode)
  849.                NOTE: Mode 100 (640x400) is skipped when using +/- above.
  850.      
  851. While viewing an array (one about to be saved, not a previously saved
  852. one):
  853.  
  854.      B    Create a BMP file (256 c) of screen contents
  855.      C    Crop an image and create a  BMP, GIF, JPG or PCX file
  856.      G    Create a GIF file (256 c) of screen contents
  857.      J    Create a JPG file (24 bit) of screen contents
  858.      Z    Create a PCX file (256 c) of screen contents
  859.  
  860. While viewing IMG or HPGL files in a B & W mode:
  861.  
  862.      P    Send XMEM contents to printer as B&W image
  863.      I    Create an IMG file (2 c) of entire XMEM contents.  The 'I'
  864.           option may also be used if you are viewing an IMG or HPGL
  865.           file in a color VESA mode.
  866.      Z    Create a PCX (2 c) file of entire XMEM contents.
  867.  
  868. In both Color and B & W modes you may pan screen with:
  869.     (make sure the NUMLOCK key is on to use keypad)
  870.  
  871.      HOME      Top left of image
  872.      END       Bottom right of image
  873.      Page Up   Move up approx. 1 inch
  874.      Page Dn   Move down approx. 1 inch
  875.      ESC       Return to File Selection Menu
  876.  
  877. The arrow keys on either numeric keypad or separate arrow keypad pan
  878. the image approx. 1/4 inch in that direction. In addition, on the
  879. numeric keypad, the 1,3,7 & 9 keys pan the image diagonally and the
  880. 5 pans to center of image.
  881.  
  882. Use the Control key with left or right arrows to pan 1 inch to the
  883. left or right.
  884.  
  885. SAVING SCREEN AS a  BMP, GIF or PCX FILE:
  886.  
  887. While viewing an image in a VESA mode, pressing <B> will save the
  888. current screen (not necessarily everything in Extended memory) to a
  889. BMP file with the filename of your choosing.  Pressing <G> will save
  890. to a GIF file.  Pressing <Z> will save to a PCX file.  The dimensions
  891. will come from the mode you are currently viewing the image in or the
  892. cropped size that you used.  The color table written to file will
  893. reflect any adjustments you've made with the Function keys.  When
  894. keying in the filename, if you don't include the period or extension,
  895. the program will append the correct extension to your keyin.  If you
  896. keyin the extension with your filename, the program will use that
  897. instead, but make sure you keyin the appropriate extension since the
  898. extension is how the program determines the file type to display!  You
  899. may precede the filename with a Disk & Directory if you don't want to
  900. use the current Disk/Dir.
  901.  
  902. SAVING SCREEN AS a JPG FILE:
  903.  
  904. JPEG is a standardized compression method for full-color (24 bit) and
  905. grayscale images.  JPEG is a lossy type of compression, meaning that
  906. the output image is not necessarily identical to the input image. 
  907. This software implements JPEG baseline and extended-sequential
  908. compression processes and the file format used is called JFIF.  This
  909. format has been agreed to by a number of major commercial JPEG vendors
  910. and probably will become the de facto standard.  Some commercial JPEG
  911. implementations are incompatible, especially if they were written
  912. before the summer of 1991.  Some other shareware JPEG program's output
  913. will only work if they have the option of outputing as JFIF standard
  914. files.
  915.  
  916. The procedure for saving the current screen to a JPG file is the same
  917. as for saving to a GIF, BMP or PCX (see above section), except that
  918. an extra question is asked after you key in the filename.   You will
  919. need to enter a JPEG quality factor ranging from 25 to 95.  The
  920. default if you just press <CR> is 75.  A higher quality factor will
  921. result in larger files and less loss of image quality.   A lower
  922. quality factor will result in smaller files with more loss of image
  923. quality.  
  924.  
  925. It is not recommended to save array images as JPG files if they will
  926. be used as graphic menus, since they will take considerably longer to
  927. decode.
  928.  
  929. CROPPING SCREEN & SAVING AS a  BMP, GIF, JPG or PCX FILE:
  930.  
  931. If you press <C> you will be able to crop your screen image before
  932. saving as a BMP, GIF, JPG or PCX file.  You will see a box drawn
  933. around your screen image when you first press <C>.  Press a <T> to
  934. move the TopLeft corner of box.  Press <B> to move the BottomRight
  935. corner. Use the arrow keys to move a single pixel at a time, or
  936. PageUp, PageDown, <CTRL>Leftarrow or <CTRL>Rightarrow to move 10
  937. pixels at a time.  <HOME> will move the Topleft corner of box to
  938. Topleft of screen.  <END> will move the Bottomright corner of box to
  939. Bottomright of screen.  <ESC> will abort and a <CR> will start the
  940. screen save. You will be prompted whether to save as a BMP, GIF, JPG
  941. or PCX file.  See 'Using a Mouse' below.
  942.  
  943. SCALING XMEM CONTENTS TO SCREEN & SAVING:
  944.  
  945. If you press <S> you will be able to scale the entire image in XMEM
  946. to your screen.  You will see a box drawn around your screen when you
  947. first press <S>.  If you just press the <CR> key at this time, your
  948. entire image will be fitted to your screen at the current VESA
  949. resolution.  Use the arrow keys etc. (like in cropping above) to move
  950. the lower right corner of box.  Scaling always occurs about the upper
  951. left corner of image, so you can't move this point. <ESC> will abort
  952. and a <CR> will start the screen save.  See 'Using Mouse' below.
  953.  
  954. SAVING XMEM CONTENTS AS an IMG or PCX FILE:
  955.  
  956. While viewing a 2 color Black/White image (either IMG, 2-color PCX or
  957. HPGL files), pressing an <I> will save the entire eXtended memory
  958. contents to a IMG file, or pressing <Z> will save as a 2-color PCX
  959. file.  You will have the opportunity to reverse the image before
  960. saving.  It doesn't matter whether you are viewing the image in a
  961. color VESA mode or one of the Black & White modes in order to save
  962. with the <I> mode, as long as the original image was actually a 2
  963. color image.  Currently, there is not a cropping option before saving
  964. as a IMG file.  However, if you are viewing the 2-color image in a
  965. color VESA mode, you could save out as a cropped BMP, GIF, JPG or PCX
  966. file.
  967.  
  968. PRINTING IMAGES:
  969.  
  970. Before displaying an image that you will be printing, you should pull
  971. up the Printer Setup Menu and Printer Model Menu (submenus of OPTS
  972. menu) and make any necessary changes to model, style, size, margins,
  973. rotation and gamma etc.  After an image is displayed, any adjustments
  974. to color/brightness/contrast will be reflected in your print.  The
  975. gamma value (see description of /PGn qualifier above) is a good tool
  976. to use if adjustment to brightness is needed for printouts.  The
  977. maximum size of image is limited only by the amount of free XMEM you
  978. have.  The maximum size of print is 10.5 x 8.0 inches on most
  979. printers.  On the DeskJet 550C printer, note that you can't print on
  980. the bottom 1/2" of page, so if you are centering your print, the
  981. maximum length can't be greater than 10.0", but if you set your Top
  982. Margin to the minimum of 0.05", you can squeeze in about 10.4".
  983.  
  984. If you want to print multiple images, select them from the file list
  985. with the <Space Bar> (or right mouse button) as for slides, and then
  986. press <P> (or point to PLOT with mouse).  Each file will be displayed
  987. on screen and automatically plotted until the last one is processed. 
  988. NOTE that all of the plots will use the same size, rotation,
  989. justification etc. from the plotting options menu.  Pressing <ESC> (or
  990. right mouse button) will abort the plotting.  NOTE:  This option is
  991. only available in Registered Versions.
  992.  
  993. While a color image file is displayed on the screen, pressing <P> will
  994. create a print on your active printer in the current print style.  The
  995. fastest print style is the halftoning process. The scatter style will
  996. produce a better quality print in most cases, but will take longer to
  997. process.  You may cancel the plot by pressing <ESC> (or right mouse
  998. button) during the plot. The port defaults to LPT1 unless you
  999. specified a command line argument of /P2 or /PF when starting the
  1000. program.  The actual plot will be of your entire image (stored in
  1001. extended memory) and not just what you may be viewing on your screen.
  1002.  
  1003. While viewing a 2-color (black & white) file or HPGL (.PLT or .HPG),
  1004. pressing <P> will create a Black & White print.  
  1005.  
  1006. See description of /FB, /FW & /FN above to preserve image context when
  1007. your print is being scaled down from the original size.  You can use
  1008. any of the printer qualifiers (available as command line qualifiers
  1009. or from the Printer Menu within program) to change the defaults for
  1010. Printer Port, Printer Type, Resolution, Rotation Angle, Width and Top
  1011. & Left Margins.  
  1012.  
  1013. If you select a Print Width greater than 8.5", the program will
  1014. automatically rotate print 90 degrees (unless 270 was already
  1015. selected).  The program will beep if you try to use an invalid
  1016. combination of size, rotation angle, margins or resolution.
  1017.  
  1018. MOUSE USE:
  1019.  
  1020. In most cases where the keypad is used to move the text cursor, a
  1021. MicroSoft compatible mouse can also be used.  You must install any
  1022. required mouse drivers before running VESAVIEW.
  1023.  
  1024. The Left button is used just like the <CR> key on the keyboard to
  1025. display one image. It is also used to select choices from pop-up
  1026. menus, to select commands at the bottom of screen and to select the
  1027. PageUp and PageDown icons from the vertical bar on the right side of
  1028. screen.
  1029.  
  1030. The Right button is used just like the <ESC> key on the keyboard to
  1031. abort displays and menus.  It is also used to mark files for use in
  1032. arrays or for displaying them as slides (like the <spacebar>).
  1033.  
  1034. If a large image has been displayed in one of the 256 color VESA
  1035. modes, holding down the Left mouse button will display a panning icon
  1036. on your screen.  The green box represents your entire image size and
  1037. the red box represents your screen size.  While holding down the Left
  1038. button, move the mouse and the red box will pan around with the green
  1039. box.  When you let go of the button, the screen with be moved to
  1040. reflect your new window area.  This mode of panning is much quicker
  1041. than using the arrow keys, although you will probably use the arrow
  1042. keys for fine tuning the pan.  If a double-beep is heard when trying
  1043. to use this feature, your image is probably smaller than your screen
  1044. and no panning is possible.
  1045.  
  1046. When Cropping an image, the Left mouse button will move the upper left
  1047. corner of the cropping box and the Right mouse button will move the
  1048. lower right corner of box.  Pressing both the Left and Right buttons
  1049. simultaneously will start the save (like pressing <CR>).  Scaling
  1050. works the same except the Left mouse button is not used (can't move
  1051. the upper left corner of scaling box).
  1052.  
  1053. RUNNING Under WINDOWS 3.1:
  1054.  
  1055. VESAVIEW can be run in a Full Screen mode from Windows 3.1.  Because
  1056. of the way Windows 3.1 allocates memory, it is suggested that you use
  1057. a  .PIF file to run VESAVIEW.  The following are recommended settings
  1058. for the PIF file when running under Windows:
  1059.      
  1060.      Program Item Properties
  1061.      Description:        VesaView       
  1062.      Command Line:       VESAVIEW.PIF
  1063.      Working Directory:  C:\GIF      <-- Path of initial image directory
  1064.      Shortcut Key:       None           
  1065.  
  1066.      (NOTE:  You can use the ICON that is delivered with VESAVIEW or
  1067.      your own.  The supplied icon is in the file VESAVIEW.ICO.)
  1068.  
  1069. Use the following for 386 ENHANCED MODE -
  1070.      PIF EDITOR - VESAVIEW.PIF
  1071.      Program Filename:   C:\VV\VESAVIEW.EXE   <-- Path of VESAVIEW.EXE
  1072.      Window Title:       VesaView       
  1073.      Optional Parameters:  /AW /AM103 /PTDJ /AS <-- Modify these as needed
  1074.      Start-up Directory:                
  1075.      Video Memory:       _  Text        _  Low Graphics    X  High Graphics
  1076.      Memory Requiremts:  KB Required   -1    KB Desired   -1
  1077.      EMS Memory:         KB Required    0    KB Limit   1024
  1078.      XMS Memory:         KB Required 1024    KB Limit     -1
  1079.      Display Usage: X  Full Screen      Execution:     _  Background
  1080.                     _  Windowed                        X  Exclusive
  1081.      X  Close Window on Exit
  1082.  
  1083.      PIF EDITOR - Advanced Options
  1084.  
  1085.      Background Priority:     50   Foreground Priority:     100
  1086.                          X  Detect Idle Time
  1087.      Memory Options:
  1088.           _  EMS Memory Locked          X  XMS Memory Locked
  1089.           _  Uses High Memory Area      X  Lock Application Memory
  1090.      Display Options:
  1091.           X  Text        _  Low Graphics          X  High Graphics
  1092.           X  Emulate Text Mode     X  Retain Video Memory
  1093.      Other Options: (leave as default)
  1094.  
  1095. Use the following for STANDARD MODE -
  1096.      PIF EDITOR - VESAVIEW.PIF
  1097.      Program Filename:   C:\VV\VESAVIEW.EXE  <-- Path of VESAVIEW.EXE
  1098.      Window Title:       VesaView       
  1099.      Optional Parameters:  /AW /AM103 /PTDJ /AS  <-- Modify these as needed
  1100.      Start-up Directory:                
  1101.      Video Memory:       _  Text           X Graphics/Multiple Text
  1102.      Memory Requiremts:  KB Required      -1
  1103.      XMS Memory:         KB Required    1024   KB Limit  -1
  1104.      Direct Modifiers:   _ COM1    _ COM3    _ Keyboard
  1105.                          _ COM2    _ COM4
  1106.      _ No Screen Exchange          _ Prevent Program Switch
  1107.      X  Close Window on Exit       _ No Save Screen
  1108.  
  1109.           
  1110. CAUTIONS:
  1111.  
  1112. The array used to store the files in current directory is limited to
  1113. 999 files.  More files than this will just be truncated from directory
  1114. listing.
  1115.  
  1116. The program determines the type of file to display by the extension
  1117. used on the filename.  Supported extensions are BMP, GIF, IMG, JPG,
  1118. PCX, TGA, TIF, HPG and PLT.  Any other extensions are ignored. 
  1119. Incorrect extensions may cause program to hang  (ie. Don't name a PCX
  1120. file with a GIF extension).
  1121.  
  1122. Even though your VESA driver thinks it supports some of the higher
  1123. resolution modes, your hardware may not have the required memory to
  1124. do so.  Therefore, you need to lockout these modes from the program
  1125. with the /LOmode command line switch.  If you don't lock out these
  1126. modes, the program may hang and you'll have to do the 3 finger trick
  1127. (<CTRL> <ALT> <DEL>).
  1128.  
  1129. When printing, make sure your printer is online before pressing the
  1130. <P> key, otherwise the printer may lose some of the data or lock up
  1131. the program.
  1132.  
  1133. HINTS:
  1134.  
  1135. When creating arrays of images that include 24 bit files, you may want
  1136. to toggle the 24 bit palette option to STANDARD to speed up the
  1137. processing. The color detail will not be too apparent at this small
  1138. scale.
  1139.  
  1140. To create and save a slide show sequence, just create an array image
  1141. and save it.  The images on the array will be arranged in the order
  1142. in which they were selected originally.  All you need to do to play
  1143. the slide show is pull up that array image, press 'M' to mark all
  1144. files, and then press the left mouse button to start the show.  You
  1145. should set the delay and fade before pulling up the array if desired.
  1146.  
  1147. It is suggested that you prefix your array filenames with a 0 (zero)
  1148. so that they will be alphabetized at the beginning of the directory
  1149. listing for easier location. (Ex.  0DIR01.GIF, 0DIR02.GIF  etc).
  1150.  
  1151. If you will be using your array images as graphic menus for file
  1152. selection, a lower resolution array image will update on the screen
  1153. faster.  Even if you have just a few images to catalog, by placing
  1154. them in a larger format array image (ie. You have only 9 images to
  1155. catalog but create a 6 x 6 array image), the screen will be able to
  1156. recall this array as a menu much faster than creating it in a 3 x 3
  1157. array image.  This is due to the greater compression of large areas
  1158. of blank space on the screen.
  1159.  
  1160. If you don't have a mouse, the graphic arrays you create can't be used
  1161. graphic menus.  You will need to manually delete the .VNX file for the
  1162. array file so that the system will think the array file is just an
  1163. ordinary image.
  1164.  
  1165. If you are using a printer supported by the DOS GRAPHICS command, you
  1166. can get a quick print of a Black & White screen by using the GRAPHICS
  1167. command before running VESAVIEW.  Version 5.0 of DOS supports the
  1168. DeskJet & LaserJets and the syntax would be:
  1169.      GRAPHICS DESKJET /r     (the /r will reverse black & white)
  1170.  
  1171.      Use <SHIFT><PRT SCRN> while graphics are on the screen to
  1172.      initiate the print.
  1173.  
  1174. If you are printing to a color printer and you need to lighten up your
  1175. print, try increasing the Gamma value instead of the brightness.  This
  1176. will lighten up the lower intensities and leave the higher intensities
  1177. as they are.
  1178.  
  1179. Besides using the SCALE option, there is a trick you can use to scale
  1180. down an image by 1/2,1/3,1/4...1/9.  Mark just one image and display
  1181. it as an array.  Select the Array Size according to the scale factor
  1182. you wish to use. (The color table used to display a single image as
  1183. an array will be the true color table of that image and not the
  1184. standard palette).  After the image is displayed, use the CROP feature
  1185. to save the area you desire as a color image.  Note that when a single
  1186. array image is displayed, the background color and text colors will
  1187. change according to the color table of the single image being
  1188. displayed.
  1189.  
  1190. If you need a VESA driver for your graphics card, login to Compuserve
  1191. and go to the IBMPRO forum (GO VESA).  In Lib #12 (Vesa), you will
  1192. find VESA drivers for almost any card.
  1193.  
  1194. If you are not sure what graphics card you have in your machine, there
  1195. is a great little program in the GRAPHSUPPORT forum on Compuserve (GO
  1196. PICS).  In Lib #14 (Misc Util & Code) download VDEOID.EXE.  This
  1197. program will try and determine the card manufacturer & memory on it.
  1198.  
  1199. CARDS TESTED:
  1200.  
  1201. This program has been tested on the following computers and graphics
  1202. cards:
  1203.  
  1204. DELL 325D - Using built-in Paradise card
  1205. DELL 325D - Using a CompuAdd Hi-rez card
  1206. DELL 433D - Using Trident 8900 card
  1207. DELL 433P - Using built-in Paradise card
  1208. DELL 433P - Using a Video-7 VRAM II card
  1209. DELL 486D/50 - Using built-in Paradise card
  1210. DELL 486D/66 - Using built-in Paradise card & ATI Ultra card
  1211. NEC 386SX - Using a CompuAdd Hi-rez card
  1212. AST 286/386 Premium - Using Orchid Designer Pro card
  1213. AST 286/386 Premium - Using Diamond Stealth card (has built in VESA
  1214.                       Bios on card)
  1215. IBM 286 AT - Using a Paradise VGA Plus
  1216. IBM 286 AT - Using an ATI Wonder card & ATI Vantage
  1217. GATEWAY 2000 486/33 - Using an ATI Ultra card
  1218. DEC PC 486 - Using built-in graphics card
  1219.  
  1220. SUPPORT:
  1221.  
  1222. If you have any comments, suggestions or questions, please leave me
  1223. a message in the GRAPHSUPPORT forum (GO PICS) on Compuserve. My CIS
  1224. ID number is 71170,2340.  The current shareware version of VESAVIEW
  1225. will always be posted in the LIB #3 (Decoders & Encoders) of the
  1226. GRAPHSUPPORT forum on Compuserve.  It can also be found on the Blue
  1227. Ridge Express Bulletin Board (804)-790-1675.  The Zipped archival of
  1228. VESAVIEW will usually be named  VESAVW.ZIP or VESAVWxx.ZIP where xx
  1229. is the version number.  If you can't find it by filename, try
  1230. searching for the keywords VESA and HPGL.  You can also reach me at
  1231. the P. O. Box listed in the Registration section.
  1232.  
  1233. REVISION HISTORY:
  1234.  
  1235. v1.0 - v1.9    Developmental versions
  1236. v2.0 (4/03/92) First release to the Public as Shareware
  1237. v2.1 (4/10/92) Changed algorithm used for arrays color palette.  Now
  1238.                uses color dithering for much more accurate color
  1239.                reproduction.
  1240. v2.2 (4/21/92) Added new option to Automatically generate multiple
  1241.                pages of array images and save them to GIF files
  1242.                without user intervention. Also added a Scaling
  1243.                option.
  1244. v2.3 (4/27/92) Fixed a minor bug while displaying multiple pages of
  1245.                arrays.
  1246. v2.4 (6/05/92) Changed GIF decoder so that files which do not follow
  1247.                the standard of setting byte 13 of header as a zero
  1248.                are decoded anyway.
  1249. v2.5 (7/6/92)  Added saving as PCX files (both 2 & 256 color).
  1250.                Added cmd line qualifiers /FN, /FB & /FW so that
  1251.                scaling of B&W images could retain more info of
  1252.                the original.  Can now read in Windows 3.X .BMP
  1253.                files (256 color).  Added ability to select files
  1254.                for display with a search string.  Added AA
  1255.                (absolute arc) & CI (circle) cmds to HPGL module
  1256.                & fixed minor bug in display size.
  1257. v2.6 (7/16/92) Added decoding of TIF (2 color) files and fixed bug
  1258.                with Filename Search option. Only decodes
  1259.                non-compressed and run-length encoded TIFs.
  1260. v2.7 (10/9/92) Added decoding of 24 bit PCX & BMP files and decoding
  1261.                of 16, 24 & 32 bit TGA (Targa) files.  Added ability
  1262.                to change command line options from within the program
  1263.                from a menu.
  1264. v2.8(11/20/92) Added qualifier to disable beep after displaying
  1265.                images. Added print enhancements: Color printing to HP
  1266.                PaintJet, PaintJet XL, PaintJet XL300, DeskJet 500C &
  1267.                DeskJet 550C.  REGISTERED VERSION ONLY:  Added ability
  1268.                to select plot size, rotation angle, resolution, gamma
  1269.                correction and page placement.  Data can now be
  1270.                compressed before sending to printer to reduce size
  1271.                and speedup printing.
  1272. V2.9 (12/9/92) Added qualifier (/COD) to optimize color palette and
  1273.                dither the image when 16, 24 or 32 bit bit images are
  1274.                read in.  Fixed a bug which wouldn't allow an array of
  1275.                images to be saved as a GIF file if no GIF file was
  1276.                displayed in the array.
  1277. V3.0(12/14/92) Added new B & W Scatter print style and Color Halftone
  1278.                print style.  Also added qualifiers for these styles
  1279.                (/PSBH, /PSBS, /PSCH & /PSCS).  Added /FTMn (fixed top
  1280.                margin).
  1281. V3.1 (1/11/93) Changed halftone printing pixels from 4 bits to 5 bits
  1282.                to allow more shades.  Added saving as a Windows BMP
  1283.                (256c).  Arrays can now be saved as either GIF, BMP or
  1284.                PCX files.  The screen is now erased around a cropped
  1285.                area before saving for easier viewing.
  1286. V3.2 (1/22/93) Added support for 16 color PCX, BMP & GIF files. 
  1287.                Added support for 256 color (8 bit) TGA files.  Saving
  1288.                of images or arrays is now 3-4 times faster.
  1289. V3.3 (2/2/93)  Added support for 16 and 256 color TIF files.
  1290.                Added ability to use 320x200x256 & 640x480x2
  1291.                modes without requiring a VESA driver.  These
  1292.                modes do not allow array generation.  Added
  1293.                panning with window icon for B&W display modes.
  1294.                Added qualifiers /PXSn & /PYSn to allow slight
  1295.                adjustment of X & Y scales when plotting HPGL &
  1296.                2-color files.  Fixed bug where multiple image
  1297.                GIFs would hang.  Now, only the 1st image of
  1298.                these multi-image GIFs is displayed.
  1299. V3.4 (2/9/93)  Added support for GIF89A files by completely
  1300.                rewriting the GIF decoder module.  Multiple files
  1301.                can now be selected for automated plotting (only
  1302.                available in Registered Version).  File directory
  1303.                is now sorted vertically instead of horizontally
  1304.                for easier viewing.  Zooming (changing
  1305.                resolution) is now possible while viewing in a
  1306.                VESA mode with the +- keys.
  1307. V3.5 (2/26/93) Fixed bug with vertical directory listing which caused
  1308.                incorrect scrolling.
  1309. V3.6 (3/18/93) Added cmd qualifiers /UPSA, /UPSB & /UPSC so user
  1310.                could select a default plot size if the .PLT file did
  1311.                not have an embedded PS cmd to signify what plot size
  1312.                to use.
  1313. V3.7 (4/12/93) Added printer output to a file option (from menu or
  1314.                new /PF qualifier).  Added support for 24 TIF and 32
  1315.                bit TGA files.
  1316. V4.0 (4/20/93) Images can now be graphically selected for display or
  1317.                printing from previously created array images.  These
  1318.                previously created arrays images act as graphic
  1319.                directory menus.  Also, a help menu is now available
  1320.                while displaying graphics.
  1321. V4.1 (5/14/93) Program now checks for sufficient disk space before
  1322.                writing out files. When keying in a filename, you
  1323.                don't have to include the extension (ex:  .GIF)
  1324.                anymore.  If your keyin doesn't contain a period, the
  1325.                appropriate extension will automatically be appended
  1326.                to your keyin.
  1327. V4.2 (5/18/93) If you have enough XMEM, the first graphic array menu
  1328.                you select will be stored in memory, so that returning
  1329.                to that menu screen will be instantaneous instead of
  1330.                having to re-read in the file on each return. This can
  1331.                be overridden with the /NLAM  qualifier.  Added a new
  1332.                Printer Model submenu to the Options Menu.
  1333. V4.3 (6/11/93) Added capability to put an array image and its index
  1334.                file on a different disk/directory than its images are
  1335.                on.  This allows cataloging of images on a CDROM etc. 
  1336.                Image sizes can now be displayed on the images of an
  1337.                array if you use the qualifier /AS (array sizes). 
  1338.                Some changes in the way stack memory was allocated
  1339.                were made to hopefully alleviate some users memory
  1340.                restraint problems.
  1341. V4.4 (7/2/93)  Added a fade in/out of images when displaying a
  1342.                slide show.  This is done with new qualifier /Fx
  1343.                or from Options Menu.  The order in which files
  1344.                are selected is now used when displaying or
  1345.                creating arrays of them.  The sequence numbers
  1346.                are shown on the text directory listing.  A
  1347.                filename mask option has been added.  The new
  1348.                qualifier /Mxxx sets the mask to use.  Enhanced
  1349.                error checking when printing to prevent hangups
  1350.                when user input print sizes & margins were
  1351.                invalid.
  1352. V4.5 (7/21/93) Added the reading and saving of 24 bit and grayscale
  1353.                JPEG files (.JPG).  Added a progress bar when reading
  1354.                in files from the graphics menu to prevent boredom.
  1355. V4.6 (7/26/93) Fixed problem where extremely long paths in filenames
  1356.                would abort program.
  1357. V4.7 (7/30/93) Fixed bug with reading in 16 bit Targa files.  Changed
  1358.                algorithm for calculating HPGL plot scale for
  1359.                different Page Sizes.  Fixed sorting of directory when
  1360.                using Auto Array Generation. Changed maximum entries
  1361.                per directory from 500 to 999.
  1362. V4.8 (8/10/93) Added more error trapping for critical hardware errors
  1363.                (such as CDrom write errors, etc), and changed the
  1364.                initial VESAVIEW Logo.
  1365. V4.9 (8/22/93) Added ability to display an ASCII file on screen. 
  1366.                Added Disk Drives to the directory listing.
  1367. v5.0 (9/9/93)  Added ability to create an array image (menu) of up to
  1368.                12 x 12 images (144 total) per page if the resolution
  1369.                you select is high enough for the filenames to display
  1370.                above images.  Added check for free diskspace when
  1371.                auto-generating arrays.  Fixed bug which caused hangups
  1372.                when displaying long JPEG error messages. Made keyin
  1373.                field larger for filename of auto-generated arrays.
  1374.                Directory listing now returns as it was bracketed on the
  1375.                screen after viewing images etc. instead of resetting to
  1376.                display file number 1.  New qualifier  /IDx  to override the
  1377.                embedded drive letter in index (.VNX) files.  Trailing
  1378.                backslashes when entering a new path are now
  1379.                tolerated.  Removed now unnecessary qualifiers /PYS
  1380.                and /PXS.  Added new registration procedure using a
  1381.                username/access code combination.
  1382.